<html><body>
<style>

body, h1, h2, h3, div, span, p, pre, a {
  margin: 0;
  padding: 0;
  border: 0;
  font-weight: inherit;
  font-style: inherit;
  font-size: 100%;
  font-family: inherit;
  vertical-align: baseline;
}

body {
  font-size: 13px;
  padding: 1em;
}

h1 {
  font-size: 26px;
  margin-bottom: 1em;
}

h2 {
  font-size: 24px;
  margin-bottom: 1em;
}

h3 {
  font-size: 20px;
  margin-bottom: 1em;
  margin-top: 1em;
}

pre, code {
  line-height: 1.5;
  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
}

pre {
  margin-top: 0.5em;
}

h1, h2, h3, p {
  font-family: Arial, sans serif;
}

h1, h2, h3 {
  border-bottom: solid #CCC 1px;
}

.toc_element {
  margin-top: 0.5em;
}

.firstline {
  margin-left: 2 em;
}

.method  {
  margin-top: 1em;
  border: solid 1px #CCC;
  padding: 1em;
  background: #EEE;
}

.details {
  font-weight: bold;
  font-size: 14px;
}

</style>

<h1><a href="displayvideo_v4.html">Display & Video 360 API</a> . <a href="displayvideo_v4.advertisers.html">advertisers</a> . <a href="displayvideo_v4.advertisers.adGroupAds.html">adGroupAds</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
  <code><a href="#close">close()</a></code></p>
<p class="firstline">Close httplib2 connections.</p>
<p class="toc_element">
  <code><a href="#get">get(advertiserId, adGroupAdId, x__xgafv=None)</a></code></p>
<p class="firstline">Gets an ad group ad.</p>
<p class="toc_element">
  <code><a href="#list">list(advertiserId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
<p class="firstline">Lists ad group ads.</p>
<p class="toc_element">
  <code><a href="#list_next">list_next()</a></code></p>
<p class="firstline">Retrieves the next page of results.</p>
<h3>Method Details</h3>
<div class="method">
    <code class="details" id="close">close()</code>
  <pre>Close httplib2 connections.</pre>
</div>

<div class="method">
    <code class="details" id="get">get(advertiserId, adGroupAdId, x__xgafv=None)</code>
  <pre>Gets an ad group ad.

Args:
  advertiserId: string, Required. The ID of the advertiser this ad group ad belongs to. (required)
  adGroupAdId: string, Required. The ID of the ad group ad to fetch. (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # A single ad associated with an ad group.
  &quot;adGroupAdId&quot;: &quot;A String&quot;, # The unique ID of the ad. Assigned by the system.
  &quot;adGroupId&quot;: &quot;A String&quot;, # The unique ID of the ad group that the ad belongs to. *Caution*: Parent ad groups for Demand Gen ads are not currently retrieveable using `advertisers.adGroups.list` or `advertisers.adGroups.get`. Demand Gen ads can be identified by the absence of the `ad_details` union field.
  &quot;adPolicy&quot;: { # A single ad policy associated with an ad group ad. # The policy approval status of the ad.
    &quot;adPolicyApprovalStatus&quot;: &quot;A String&quot;, # The policy approval status of an ad, indicating the approval decision.
    &quot;adPolicyReviewStatus&quot;: &quot;A String&quot;, # The policy review status of an ad, indicating where in the review process the ad is currently.
    &quot;adPolicyTopicEntry&quot;: [ # The entries for each policy topic identified as relating to the ad. Each entry includes the topic, restriction level, and guidance on how to fix policy issues.
      { # An entry describing how an ad has been identified as relating to an ad policy.
        &quot;appealInfo&quot;: { # Information on how to appeal a policy decision. # Information on how to appeal the policy decision.
          &quot;appealFormLink&quot;: &quot;A String&quot;, # Only available when appeal_type is `APPEAL_FORM`.
          &quot;appealType&quot;: &quot;A String&quot;, # Whether the decision can be appealed through a self-service appeal or an appeal form.
        },
        &quot;helpCenterLink&quot;: &quot;A String&quot;, # Ad policy help center link for the policy topic.
        &quot;policyDecisionType&quot;: &quot;A String&quot;, # The source of the policy decision.
        &quot;policyEnforcementMeans&quot;: &quot;A String&quot;, # The policy enforcement means used in the policy review.
        &quot;policyLabel&quot;: &quot;A String&quot;, # Localized label text for policy. Examples include &quot;Trademarks in text&quot;, &quot;Contains Alcohol&quot;, etc.
        &quot;policyTopic&quot;: &quot;A String&quot;, # The policy topic. Examples include &quot;TRADEMARKS&quot;, &quot;ALCOHOL&quot;, etc.
        &quot;policyTopicConstraints&quot;: [ # The serving constraints relevant to the policy decision.
          { # Details on ad serving constraints.
            &quot;certificateDomainMismatchCountryList&quot;: { # A list of countries where the ad cannot serve due to policy constraints. # Countries where the resource&#x27;s domain is not covered by the certificates associated with it.
              &quot;countries&quot;: [ # Countries where the ad cannot serve.
                { # Represents a country restriction.
                  &quot;countryCriterionId&quot;: &quot;A String&quot;, # The country criterion id.
                  &quot;countryLabel&quot;: &quot;A String&quot;, # Localized name for the country. May be empty.
                },
              ],
            },
            &quot;certificateMissingCountryList&quot;: { # A list of countries where the ad cannot serve due to policy constraints. # Countries where a certificate is required for serving.
              &quot;countries&quot;: [ # Countries where the ad cannot serve.
                { # Represents a country restriction.
                  &quot;countryCriterionId&quot;: &quot;A String&quot;, # The country criterion id.
                  &quot;countryLabel&quot;: &quot;A String&quot;, # Localized name for the country. May be empty.
                },
              ],
            },
            &quot;countryConstraint&quot;: { # A list of countries where the ad cannot serve due to policy constraints. # Countries where the ad cannot serve.
              &quot;countries&quot;: [ # Countries where the ad cannot serve.
                { # Represents a country restriction.
                  &quot;countryCriterionId&quot;: &quot;A String&quot;, # The country criterion id.
                  &quot;countryLabel&quot;: &quot;A String&quot;, # Localized name for the country. May be empty.
                },
              ],
            },
            &quot;globalCertificateDomainMismatch&quot;: { # Certificate is required to serve in any country and the existing certificate does not cover the ad&#x27;s domain. # Certificate is required to serve in any country and the existing certificate does not cover the ad&#x27;s domain.
            },
            &quot;globalCertificateMissing&quot;: { # Certificate is required to serve in any country. # Certificate is required to serve in any country.
            },
            &quot;requestCertificateFormLink&quot;: &quot;A String&quot;, # Link to the form to request a certificate for the constraint.
            &quot;resellerConstraint&quot;: { # Policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
            },
          },
        ],
        &quot;policyTopicDescription&quot;: &quot;A String&quot;, # A short summary description of the policy topic.
        &quot;policyTopicEvidences&quot;: [ # The evidence used in the policy decision.
          { # Evidence information used in the policy decision.
            &quot;counterfeit&quot;: { # Details on the counterfeit enforcement that caused a policy violation. # Counterfeit enforcement that caused a policy violation.
              &quot;owners&quot;: [ # The content or product owners that made a complaint.
                &quot;A String&quot;,
              ],
            },
            &quot;destinationMismatch&quot;: { # Details on a mismatch between destination URL types. # A mismatch between the ad destination URLs.
              &quot;uriTypes&quot;: [ # The set of URLs that do not match. The list can include single or multiple uri types. Example 1: [`DISPLAY_URL`, `FINAL_URL`] means ad display URL does not match with the ad final URL. Example 2: [`FINAL_URL`] means ad final URL did not match the crawled url, which is also considered as destination mismatch.
                &quot;A String&quot;,
              ],
            },
            &quot;destinationNotWorking&quot;: { # Details for on HTTP or DNS errors related to the ad destination. # Information on HTTP or DNS errors related to the ad destination.
              &quot;device&quot;: &quot;A String&quot;, # The device where visiting the URL resulted in the error.
              &quot;dnsErrorType&quot;: &quot;A String&quot;, # The type of DNS error.
              &quot;expandedUri&quot;: &quot;A String&quot;, # The full URL that didn&#x27;t work.
              &quot;httpErrorCode&quot;: &quot;A String&quot;, # The HTTP error code.
              &quot;lastCheckedTime&quot;: &quot;A String&quot;, # The last time the error was seen when navigating to URL.
            },
            &quot;destinationTextList&quot;: { # A list of destination text that violated the policy. # The text in the destination of the ad that is causing a policy violation.
              &quot;destinationTexts&quot;: [ # Destination text that caused the policy finding.
                &quot;A String&quot;,
              ],
            },
            &quot;httpCode&quot;: 42, # HTTP code returned when the final URL was crawled.
            &quot;languageCode&quot;: &quot;A String&quot;, # The language the ad was detected to be written in. This field uses IETF language tags, such as &quot;en-US&quot;.
            &quot;legalRemoval&quot;: { # Legal related regulation enforcement, either from DMCA or local legal regulation. # Legal related regulation enforcement that caused a policy violation.
              &quot;complaintType&quot;: &quot;A String&quot;, # The type of complaint causing the legal removal.
              &quot;countryRestrictions&quot;: [ # The countries restricted due to the legal removal.
                { # Represents a country restriction.
                  &quot;countryCriterionId&quot;: &quot;A String&quot;, # The country criterion id.
                  &quot;countryLabel&quot;: &quot;A String&quot;, # Localized name for the country. May be empty.
                },
              ],
              &quot;dmca&quot;: { # DMCA complaint details. # Details on the DMCA regulation legal removal.
                &quot;complainant&quot;: &quot;A String&quot;, # The entity who made the legal complaint.
              },
              &quot;localLegal&quot;: { # Local legal regulation details. # Details on the local legal regulation legal removal.
                &quot;lawType&quot;: &quot;A String&quot;, # Type of law for the legal notice.
              },
              &quot;restrictedUris&quot;: [ # The urls restricted due to the legal removal.
                &quot;A String&quot;,
              ],
            },
            &quot;regionalRequirements&quot;: { # Trust &amp; Safety (T&amp;S) proactive enforcement for policies meant to address regional requirements. This is considered a Google-owned investigation instead of a regulation notice since it&#x27;s proactive T&amp;S enforcement. # T&amp;S proactive enforcement that caused a policy violation.
              &quot;regionalRequirementsEntries&quot;: [ # List of regional requirements.
                { # Policy level regional legal violation details.
                  &quot;countryRestrictions&quot;: [ # The countries restricted due to the legal policy.
                    { # Represents a country restriction.
                      &quot;countryCriterionId&quot;: &quot;A String&quot;, # The country criterion id.
                      &quot;countryLabel&quot;: &quot;A String&quot;, # Localized name for the country. May be empty.
                    },
                  ],
                  &quot;legalPolicy&quot;: &quot;A String&quot;, # The legal policy that is being violated.
                },
              ],
            },
            &quot;textList&quot;: { # A list of fragments of text that violated the policy. # List of evidence found in the text of the ad.
              &quot;texts&quot;: [ # The fragments of text from the resource that caused the policy finding.
                &quot;A String&quot;,
              ],
            },
            &quot;trademark&quot;: { # Trademark terms that caused a policy violation. # Trademark terms that caused a policy violation.
              &quot;countryRestrictions&quot;: [ # Countries where the policy violation is relevant.
                { # Represents a country restriction.
                  &quot;countryCriterionId&quot;: &quot;A String&quot;, # The country criterion id.
                  &quot;countryLabel&quot;: &quot;A String&quot;, # Localized name for the country. May be empty.
                },
              ],
              &quot;owner&quot;: &quot;A String&quot;, # The trademark content owner.
              &quot;term&quot;: &quot;A String&quot;, # The trademark term.
            },
            &quot;websiteList&quot;: { # A list of websites that violated the policy. # List of websites linked with the ad.
              &quot;websites&quot;: [ # Websites that caused the policy finding.
                &quot;A String&quot;,
              ],
            },
          },
        ],
        &quot;policyTopicType&quot;: &quot;A String&quot;, # How ad serving will be affected due to the relation to the ad policy topic.
      },
    ],
  },
  &quot;adUrls&quot;: [ # List of URLs used by the ad.
    { # Additional URLs related to the ad, including beacons.
      &quot;type&quot;: &quot;A String&quot;, # The type of the Ad URL.
      &quot;url&quot;: &quot;A String&quot;, # The URL string value.
    },
  ],
  &quot;advertiserId&quot;: &quot;A String&quot;, # The unique ID of the advertiser the ad belongs to.
  &quot;audioAd&quot;: { # Details for an audio ad. # Details of an [audio ad](//support.google.com/displayvideo/answer/6274216) used for reach marketing objectives.
    &quot;displayUrl&quot;: &quot;A String&quot;, # The webpage address that appears with the ad.
    &quot;finalUrl&quot;: &quot;A String&quot;, # The URL address of the webpage that people reach after they click the ad.
    &quot;trackingUrl&quot;: &quot;A String&quot;, # The URL address loaded in the background for tracking purposes.
    &quot;video&quot;: { # Details of a YouTube video. # The YouTube video of the ad.
      &quot;id&quot;: &quot;A String&quot;, # The YouTube video ID which can be searched on YouTube webpage.
      &quot;unavailableReason&quot;: &quot;A String&quot;, # The reason why the video data is not available.
    },
  },
  &quot;bumperAd&quot;: { # Details for a bumper ad. # Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach.
    &quot;commonInStreamAttribute&quot;: { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes.
      &quot;actionButtonLabel&quot;: &quot;A String&quot;, # The text on the call-to-action button.
      &quot;actionHeadline&quot;: &quot;A String&quot;, # The headline of the call-to-action banner.
      &quot;companionBanner&quot;: { # Meta data of an image asset. # The image which shows next to the video ad.
        &quot;fileSize&quot;: &quot;A String&quot;, # File size of the image asset in bytes.
        &quot;fullSize&quot;: { # Dimensions. # Metadata for this image at its original size.
          &quot;heightPixels&quot;: 42, # The height in pixels.
          &quot;widthPixels&quot;: 42, # The width in pixels.
        },
        &quot;mimeType&quot;: &quot;A String&quot;, # MIME type of the image asset.
      },
      &quot;displayUrl&quot;: &quot;A String&quot;, # The webpage address that appears with the ad.
      &quot;finalUrl&quot;: &quot;A String&quot;, # The URL address of the webpage that people reach after they click the ad.
      &quot;trackingUrl&quot;: &quot;A String&quot;, # The URL address loaded in the background for tracking purposes.
      &quot;video&quot;: { # Details of a YouTube video. # The YouTube video of the ad.
        &quot;id&quot;: &quot;A String&quot;, # The YouTube video ID which can be searched on YouTube webpage.
        &quot;unavailableReason&quot;: &quot;A String&quot;, # The reason why the video data is not available.
      },
    },
  },
  &quot;displayName&quot;: &quot;A String&quot;, # The display name of the ad. Must be UTF-8 encoded with a maximum size of 255 bytes.
  &quot;displayVideoSourceAd&quot;: { # The ad sourced from a DV360 creative. # Details of an ad sourced from a Display &amp; Video 360 creative.
    &quot;creativeId&quot;: &quot;A String&quot;, # The ID of the source creative.
  },
  &quot;entityStatus&quot;: &quot;A String&quot;, # The entity status of the ad.
  &quot;inStreamAd&quot;: { # Details for an in-stream ad. # Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives.
    &quot;commonInStreamAttribute&quot;: { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes.
      &quot;actionButtonLabel&quot;: &quot;A String&quot;, # The text on the call-to-action button.
      &quot;actionHeadline&quot;: &quot;A String&quot;, # The headline of the call-to-action banner.
      &quot;companionBanner&quot;: { # Meta data of an image asset. # The image which shows next to the video ad.
        &quot;fileSize&quot;: &quot;A String&quot;, # File size of the image asset in bytes.
        &quot;fullSize&quot;: { # Dimensions. # Metadata for this image at its original size.
          &quot;heightPixels&quot;: 42, # The height in pixels.
          &quot;widthPixels&quot;: 42, # The width in pixels.
        },
        &quot;mimeType&quot;: &quot;A String&quot;, # MIME type of the image asset.
      },
      &quot;displayUrl&quot;: &quot;A String&quot;, # The webpage address that appears with the ad.
      &quot;finalUrl&quot;: &quot;A String&quot;, # The URL address of the webpage that people reach after they click the ad.
      &quot;trackingUrl&quot;: &quot;A String&quot;, # The URL address loaded in the background for tracking purposes.
      &quot;video&quot;: { # Details of a YouTube video. # The YouTube video of the ad.
        &quot;id&quot;: &quot;A String&quot;, # The YouTube video ID which can be searched on YouTube webpage.
        &quot;unavailableReason&quot;: &quot;A String&quot;, # The reason why the video data is not available.
      },
    },
    &quot;customParameters&quot;: { # The custom parameters to pass custom values to tracking URL template.
      &quot;a_key&quot;: &quot;A String&quot;,
    },
  },
  &quot;mastheadAd&quot;: { # Details for a Masthead Ad. # Details of an [ad served on the YouTube Home feed](//support.google.com/google-ads/answer/9709826).
    &quot;autoplayVideoDuration&quot;: &quot;A String&quot;, # The duration of time the video will autoplay.
    &quot;autoplayVideoStartMillisecond&quot;: &quot;A String&quot;, # The amount of time in milliseconds after which the video will start to play.
    &quot;callToActionButtonLabel&quot;: &quot;A String&quot;, # The text on the call-to-action button.
    &quot;callToActionFinalUrl&quot;: &quot;A String&quot;, # The destination URL for the call-to-action button.
    &quot;callToActionTrackingUrl&quot;: &quot;A String&quot;, # The tracking URL for the call-to-action button.
    &quot;companionYoutubeVideos&quot;: [ # The videos that appear next to the Masthead Ad on desktop. Can be no more than two.
      { # Details of a YouTube video.
        &quot;id&quot;: &quot;A String&quot;, # The YouTube video ID which can be searched on YouTube webpage.
        &quot;unavailableReason&quot;: &quot;A String&quot;, # The reason why the video data is not available.
      },
    ],
    &quot;description&quot;: &quot;A String&quot;, # The description of the ad.
    &quot;headline&quot;: &quot;A String&quot;, # The headline of the ad.
    &quot;showChannelArt&quot;: True or False, # Whether to show a background or banner that appears at the top of a YouTube page.
    &quot;video&quot;: { # Details of a YouTube video. # The YouTube video used by the ad.
      &quot;id&quot;: &quot;A String&quot;, # The YouTube video ID which can be searched on YouTube webpage.
      &quot;unavailableReason&quot;: &quot;A String&quot;, # The reason why the video data is not available.
    },
    &quot;videoAspectRatio&quot;: &quot;A String&quot;, # The aspect ratio of the autoplaying YouTube video on the Masthead.
  },
  &quot;name&quot;: &quot;A String&quot;, # The resource name of the ad.
  &quot;nonSkippableAd&quot;: { # Details for a non-skippable ad. # Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives.
    &quot;commonInStreamAttribute&quot;: { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes.
      &quot;actionButtonLabel&quot;: &quot;A String&quot;, # The text on the call-to-action button.
      &quot;actionHeadline&quot;: &quot;A String&quot;, # The headline of the call-to-action banner.
      &quot;companionBanner&quot;: { # Meta data of an image asset. # The image which shows next to the video ad.
        &quot;fileSize&quot;: &quot;A String&quot;, # File size of the image asset in bytes.
        &quot;fullSize&quot;: { # Dimensions. # Metadata for this image at its original size.
          &quot;heightPixels&quot;: 42, # The height in pixels.
          &quot;widthPixels&quot;: 42, # The width in pixels.
        },
        &quot;mimeType&quot;: &quot;A String&quot;, # MIME type of the image asset.
      },
      &quot;displayUrl&quot;: &quot;A String&quot;, # The webpage address that appears with the ad.
      &quot;finalUrl&quot;: &quot;A String&quot;, # The URL address of the webpage that people reach after they click the ad.
      &quot;trackingUrl&quot;: &quot;A String&quot;, # The URL address loaded in the background for tracking purposes.
      &quot;video&quot;: { # Details of a YouTube video. # The YouTube video of the ad.
        &quot;id&quot;: &quot;A String&quot;, # The YouTube video ID which can be searched on YouTube webpage.
        &quot;unavailableReason&quot;: &quot;A String&quot;, # The reason why the video data is not available.
      },
    },
    &quot;customParameters&quot;: { # The custom parameters to pass custom values to tracking URL template.
      &quot;a_key&quot;: &quot;A String&quot;,
    },
  },
  &quot;videoDiscoverAd&quot;: { # Details for a video discovery ad. # Details of an [ad promoting a video](//support.google.com/displayvideo/answer/6274216) that shows in places of discovery.
    &quot;description1&quot;: &quot;A String&quot;, # First text line for the ad.
    &quot;description2&quot;: &quot;A String&quot;, # Second text line for the ad.
    &quot;headline&quot;: &quot;A String&quot;, # The headline of ad.
    &quot;thumbnail&quot;: &quot;A String&quot;, # Thumbnail image used in the ad.
    &quot;video&quot;: { # Details of a YouTube video. # The YouTube video the ad promotes.
      &quot;id&quot;: &quot;A String&quot;, # The YouTube video ID which can be searched on YouTube webpage.
      &quot;unavailableReason&quot;: &quot;A String&quot;, # The reason why the video data is not available.
    },
  },
  &quot;videoPerformanceAd&quot;: { # Details for a video performance ad. # Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product.
    &quot;actionButtonLabels&quot;: [ # The list of text assets shown on the call-to-action button.
      &quot;A String&quot;,
    ],
    &quot;companionBanners&quot;: [ # The list of companion banners used by this ad.
      { # Meta data of an image asset.
        &quot;fileSize&quot;: &quot;A String&quot;, # File size of the image asset in bytes.
        &quot;fullSize&quot;: { # Dimensions. # Metadata for this image at its original size.
          &quot;heightPixels&quot;: 42, # The height in pixels.
          &quot;widthPixels&quot;: 42, # The width in pixels.
        },
        &quot;mimeType&quot;: &quot;A String&quot;, # MIME type of the image asset.
      },
    ],
    &quot;customParameters&quot;: { # The custom parameters to pass custom values to tracking URL template.
      &quot;a_key&quot;: &quot;A String&quot;,
    },
    &quot;descriptions&quot;: [ # The list of descriptions shown on the call-to-action banner.
      &quot;A String&quot;,
    ],
    &quot;displayUrlBreadcrumb1&quot;: &quot;A String&quot;, # The first piece after the domain in the display URL.
    &quot;displayUrlBreadcrumb2&quot;: &quot;A String&quot;, # The second piece after the domain in the display URL.
    &quot;domain&quot;: &quot;A String&quot;, # The domain of the display URL.
    &quot;finalUrl&quot;: &quot;A String&quot;, # The URL address of the webpage that people reach after they click the ad.
    &quot;headlines&quot;: [ # The list of headlines shown on the call-to-action banner.
      &quot;A String&quot;,
    ],
    &quot;longHeadlines&quot;: [ # The list of lone headlines shown on the call-to-action banner.
      &quot;A String&quot;,
    ],
    &quot;trackingUrl&quot;: &quot;A String&quot;, # The URL address loaded in the background for tracking purposes.
    &quot;videos&quot;: [ # The list of YouTube video assets used by this ad.
      { # Details of a YouTube video.
        &quot;id&quot;: &quot;A String&quot;, # The YouTube video ID which can be searched on YouTube webpage.
        &quot;unavailableReason&quot;: &quot;A String&quot;, # The reason why the video data is not available.
      },
    ],
  },
}</pre>
</div>

<div class="method">
    <code class="details" id="list">list(advertiserId, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)</code>
  <pre>Lists ad group ads.

Args:
  advertiserId: string, Required. The ID of the advertiser the ad groups belongs to. (required)
  filter: string, Optional. Allows filtering by custom ad group ad fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` and `OR`. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * All fields must use the `EQUALS (=)` operator. Supported fields: * `adGroupId` * `displayName` * `entityStatus` * `adGroupAdId` Examples: * All ad group ads under an ad group: `adGroupId=&quot;1234&quot;` * All ad group ads under an ad group with an entityStatus of `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED`: `(entityStatus=&quot;ENTITY_STATUS_ACTIVE&quot; OR entityStatus=&quot;ENTITY_STATUS_PAUSED&quot;) AND adGroupId=&quot;12345&quot;` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.
  orderBy: string, Optional. Field by which to sort the list. Acceptable values are: * `displayName` (default) * `entityStatus` The default sorting order is ascending. To specify descending order for a field, a suffix &quot;desc&quot; should be added to the field name. Example: `displayName desc`.
  pageSize: integer, Optional. Requested page size. Must be between `1` and `100`. If unspecified will default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is specified.
  pageToken: string, Optional. A token identifying a page of results the server should return. Typically, this is the value of next_page_token returned from the previous call to `ListAdGroupAds` method. If not specified, the first page of results will be returned.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    {
  &quot;adGroupAds&quot;: [ # The list of ad group ads. This list will be absent if empty.
    { # A single ad associated with an ad group.
      &quot;adGroupAdId&quot;: &quot;A String&quot;, # The unique ID of the ad. Assigned by the system.
      &quot;adGroupId&quot;: &quot;A String&quot;, # The unique ID of the ad group that the ad belongs to. *Caution*: Parent ad groups for Demand Gen ads are not currently retrieveable using `advertisers.adGroups.list` or `advertisers.adGroups.get`. Demand Gen ads can be identified by the absence of the `ad_details` union field.
      &quot;adPolicy&quot;: { # A single ad policy associated with an ad group ad. # The policy approval status of the ad.
        &quot;adPolicyApprovalStatus&quot;: &quot;A String&quot;, # The policy approval status of an ad, indicating the approval decision.
        &quot;adPolicyReviewStatus&quot;: &quot;A String&quot;, # The policy review status of an ad, indicating where in the review process the ad is currently.
        &quot;adPolicyTopicEntry&quot;: [ # The entries for each policy topic identified as relating to the ad. Each entry includes the topic, restriction level, and guidance on how to fix policy issues.
          { # An entry describing how an ad has been identified as relating to an ad policy.
            &quot;appealInfo&quot;: { # Information on how to appeal a policy decision. # Information on how to appeal the policy decision.
              &quot;appealFormLink&quot;: &quot;A String&quot;, # Only available when appeal_type is `APPEAL_FORM`.
              &quot;appealType&quot;: &quot;A String&quot;, # Whether the decision can be appealed through a self-service appeal or an appeal form.
            },
            &quot;helpCenterLink&quot;: &quot;A String&quot;, # Ad policy help center link for the policy topic.
            &quot;policyDecisionType&quot;: &quot;A String&quot;, # The source of the policy decision.
            &quot;policyEnforcementMeans&quot;: &quot;A String&quot;, # The policy enforcement means used in the policy review.
            &quot;policyLabel&quot;: &quot;A String&quot;, # Localized label text for policy. Examples include &quot;Trademarks in text&quot;, &quot;Contains Alcohol&quot;, etc.
            &quot;policyTopic&quot;: &quot;A String&quot;, # The policy topic. Examples include &quot;TRADEMARKS&quot;, &quot;ALCOHOL&quot;, etc.
            &quot;policyTopicConstraints&quot;: [ # The serving constraints relevant to the policy decision.
              { # Details on ad serving constraints.
                &quot;certificateDomainMismatchCountryList&quot;: { # A list of countries where the ad cannot serve due to policy constraints. # Countries where the resource&#x27;s domain is not covered by the certificates associated with it.
                  &quot;countries&quot;: [ # Countries where the ad cannot serve.
                    { # Represents a country restriction.
                      &quot;countryCriterionId&quot;: &quot;A String&quot;, # The country criterion id.
                      &quot;countryLabel&quot;: &quot;A String&quot;, # Localized name for the country. May be empty.
                    },
                  ],
                },
                &quot;certificateMissingCountryList&quot;: { # A list of countries where the ad cannot serve due to policy constraints. # Countries where a certificate is required for serving.
                  &quot;countries&quot;: [ # Countries where the ad cannot serve.
                    { # Represents a country restriction.
                      &quot;countryCriterionId&quot;: &quot;A String&quot;, # The country criterion id.
                      &quot;countryLabel&quot;: &quot;A String&quot;, # Localized name for the country. May be empty.
                    },
                  ],
                },
                &quot;countryConstraint&quot;: { # A list of countries where the ad cannot serve due to policy constraints. # Countries where the ad cannot serve.
                  &quot;countries&quot;: [ # Countries where the ad cannot serve.
                    { # Represents a country restriction.
                      &quot;countryCriterionId&quot;: &quot;A String&quot;, # The country criterion id.
                      &quot;countryLabel&quot;: &quot;A String&quot;, # Localized name for the country. May be empty.
                    },
                  ],
                },
                &quot;globalCertificateDomainMismatch&quot;: { # Certificate is required to serve in any country and the existing certificate does not cover the ad&#x27;s domain. # Certificate is required to serve in any country and the existing certificate does not cover the ad&#x27;s domain.
                },
                &quot;globalCertificateMissing&quot;: { # Certificate is required to serve in any country. # Certificate is required to serve in any country.
                },
                &quot;requestCertificateFormLink&quot;: &quot;A String&quot;, # Link to the form to request a certificate for the constraint.
                &quot;resellerConstraint&quot;: { # Policy topic was constrained due to disapproval of the website for reseller purposes. # Reseller constraint.
                },
              },
            ],
            &quot;policyTopicDescription&quot;: &quot;A String&quot;, # A short summary description of the policy topic.
            &quot;policyTopicEvidences&quot;: [ # The evidence used in the policy decision.
              { # Evidence information used in the policy decision.
                &quot;counterfeit&quot;: { # Details on the counterfeit enforcement that caused a policy violation. # Counterfeit enforcement that caused a policy violation.
                  &quot;owners&quot;: [ # The content or product owners that made a complaint.
                    &quot;A String&quot;,
                  ],
                },
                &quot;destinationMismatch&quot;: { # Details on a mismatch between destination URL types. # A mismatch between the ad destination URLs.
                  &quot;uriTypes&quot;: [ # The set of URLs that do not match. The list can include single or multiple uri types. Example 1: [`DISPLAY_URL`, `FINAL_URL`] means ad display URL does not match with the ad final URL. Example 2: [`FINAL_URL`] means ad final URL did not match the crawled url, which is also considered as destination mismatch.
                    &quot;A String&quot;,
                  ],
                },
                &quot;destinationNotWorking&quot;: { # Details for on HTTP or DNS errors related to the ad destination. # Information on HTTP or DNS errors related to the ad destination.
                  &quot;device&quot;: &quot;A String&quot;, # The device where visiting the URL resulted in the error.
                  &quot;dnsErrorType&quot;: &quot;A String&quot;, # The type of DNS error.
                  &quot;expandedUri&quot;: &quot;A String&quot;, # The full URL that didn&#x27;t work.
                  &quot;httpErrorCode&quot;: &quot;A String&quot;, # The HTTP error code.
                  &quot;lastCheckedTime&quot;: &quot;A String&quot;, # The last time the error was seen when navigating to URL.
                },
                &quot;destinationTextList&quot;: { # A list of destination text that violated the policy. # The text in the destination of the ad that is causing a policy violation.
                  &quot;destinationTexts&quot;: [ # Destination text that caused the policy finding.
                    &quot;A String&quot;,
                  ],
                },
                &quot;httpCode&quot;: 42, # HTTP code returned when the final URL was crawled.
                &quot;languageCode&quot;: &quot;A String&quot;, # The language the ad was detected to be written in. This field uses IETF language tags, such as &quot;en-US&quot;.
                &quot;legalRemoval&quot;: { # Legal related regulation enforcement, either from DMCA or local legal regulation. # Legal related regulation enforcement that caused a policy violation.
                  &quot;complaintType&quot;: &quot;A String&quot;, # The type of complaint causing the legal removal.
                  &quot;countryRestrictions&quot;: [ # The countries restricted due to the legal removal.
                    { # Represents a country restriction.
                      &quot;countryCriterionId&quot;: &quot;A String&quot;, # The country criterion id.
                      &quot;countryLabel&quot;: &quot;A String&quot;, # Localized name for the country. May be empty.
                    },
                  ],
                  &quot;dmca&quot;: { # DMCA complaint details. # Details on the DMCA regulation legal removal.
                    &quot;complainant&quot;: &quot;A String&quot;, # The entity who made the legal complaint.
                  },
                  &quot;localLegal&quot;: { # Local legal regulation details. # Details on the local legal regulation legal removal.
                    &quot;lawType&quot;: &quot;A String&quot;, # Type of law for the legal notice.
                  },
                  &quot;restrictedUris&quot;: [ # The urls restricted due to the legal removal.
                    &quot;A String&quot;,
                  ],
                },
                &quot;regionalRequirements&quot;: { # Trust &amp; Safety (T&amp;S) proactive enforcement for policies meant to address regional requirements. This is considered a Google-owned investigation instead of a regulation notice since it&#x27;s proactive T&amp;S enforcement. # T&amp;S proactive enforcement that caused a policy violation.
                  &quot;regionalRequirementsEntries&quot;: [ # List of regional requirements.
                    { # Policy level regional legal violation details.
                      &quot;countryRestrictions&quot;: [ # The countries restricted due to the legal policy.
                        { # Represents a country restriction.
                          &quot;countryCriterionId&quot;: &quot;A String&quot;, # The country criterion id.
                          &quot;countryLabel&quot;: &quot;A String&quot;, # Localized name for the country. May be empty.
                        },
                      ],
                      &quot;legalPolicy&quot;: &quot;A String&quot;, # The legal policy that is being violated.
                    },
                  ],
                },
                &quot;textList&quot;: { # A list of fragments of text that violated the policy. # List of evidence found in the text of the ad.
                  &quot;texts&quot;: [ # The fragments of text from the resource that caused the policy finding.
                    &quot;A String&quot;,
                  ],
                },
                &quot;trademark&quot;: { # Trademark terms that caused a policy violation. # Trademark terms that caused a policy violation.
                  &quot;countryRestrictions&quot;: [ # Countries where the policy violation is relevant.
                    { # Represents a country restriction.
                      &quot;countryCriterionId&quot;: &quot;A String&quot;, # The country criterion id.
                      &quot;countryLabel&quot;: &quot;A String&quot;, # Localized name for the country. May be empty.
                    },
                  ],
                  &quot;owner&quot;: &quot;A String&quot;, # The trademark content owner.
                  &quot;term&quot;: &quot;A String&quot;, # The trademark term.
                },
                &quot;websiteList&quot;: { # A list of websites that violated the policy. # List of websites linked with the ad.
                  &quot;websites&quot;: [ # Websites that caused the policy finding.
                    &quot;A String&quot;,
                  ],
                },
              },
            ],
            &quot;policyTopicType&quot;: &quot;A String&quot;, # How ad serving will be affected due to the relation to the ad policy topic.
          },
        ],
      },
      &quot;adUrls&quot;: [ # List of URLs used by the ad.
        { # Additional URLs related to the ad, including beacons.
          &quot;type&quot;: &quot;A String&quot;, # The type of the Ad URL.
          &quot;url&quot;: &quot;A String&quot;, # The URL string value.
        },
      ],
      &quot;advertiserId&quot;: &quot;A String&quot;, # The unique ID of the advertiser the ad belongs to.
      &quot;audioAd&quot;: { # Details for an audio ad. # Details of an [audio ad](//support.google.com/displayvideo/answer/6274216) used for reach marketing objectives.
        &quot;displayUrl&quot;: &quot;A String&quot;, # The webpage address that appears with the ad.
        &quot;finalUrl&quot;: &quot;A String&quot;, # The URL address of the webpage that people reach after they click the ad.
        &quot;trackingUrl&quot;: &quot;A String&quot;, # The URL address loaded in the background for tracking purposes.
        &quot;video&quot;: { # Details of a YouTube video. # The YouTube video of the ad.
          &quot;id&quot;: &quot;A String&quot;, # The YouTube video ID which can be searched on YouTube webpage.
          &quot;unavailableReason&quot;: &quot;A String&quot;, # The reason why the video data is not available.
        },
      },
      &quot;bumperAd&quot;: { # Details for a bumper ad. # Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach.
        &quot;commonInStreamAttribute&quot;: { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes.
          &quot;actionButtonLabel&quot;: &quot;A String&quot;, # The text on the call-to-action button.
          &quot;actionHeadline&quot;: &quot;A String&quot;, # The headline of the call-to-action banner.
          &quot;companionBanner&quot;: { # Meta data of an image asset. # The image which shows next to the video ad.
            &quot;fileSize&quot;: &quot;A String&quot;, # File size of the image asset in bytes.
            &quot;fullSize&quot;: { # Dimensions. # Metadata for this image at its original size.
              &quot;heightPixels&quot;: 42, # The height in pixels.
              &quot;widthPixels&quot;: 42, # The width in pixels.
            },
            &quot;mimeType&quot;: &quot;A String&quot;, # MIME type of the image asset.
          },
          &quot;displayUrl&quot;: &quot;A String&quot;, # The webpage address that appears with the ad.
          &quot;finalUrl&quot;: &quot;A String&quot;, # The URL address of the webpage that people reach after they click the ad.
          &quot;trackingUrl&quot;: &quot;A String&quot;, # The URL address loaded in the background for tracking purposes.
          &quot;video&quot;: { # Details of a YouTube video. # The YouTube video of the ad.
            &quot;id&quot;: &quot;A String&quot;, # The YouTube video ID which can be searched on YouTube webpage.
            &quot;unavailableReason&quot;: &quot;A String&quot;, # The reason why the video data is not available.
          },
        },
      },
      &quot;displayName&quot;: &quot;A String&quot;, # The display name of the ad. Must be UTF-8 encoded with a maximum size of 255 bytes.
      &quot;displayVideoSourceAd&quot;: { # The ad sourced from a DV360 creative. # Details of an ad sourced from a Display &amp; Video 360 creative.
        &quot;creativeId&quot;: &quot;A String&quot;, # The ID of the source creative.
      },
      &quot;entityStatus&quot;: &quot;A String&quot;, # The entity status of the ad.
      &quot;inStreamAd&quot;: { # Details for an in-stream ad. # Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives.
        &quot;commonInStreamAttribute&quot;: { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes.
          &quot;actionButtonLabel&quot;: &quot;A String&quot;, # The text on the call-to-action button.
          &quot;actionHeadline&quot;: &quot;A String&quot;, # The headline of the call-to-action banner.
          &quot;companionBanner&quot;: { # Meta data of an image asset. # The image which shows next to the video ad.
            &quot;fileSize&quot;: &quot;A String&quot;, # File size of the image asset in bytes.
            &quot;fullSize&quot;: { # Dimensions. # Metadata for this image at its original size.
              &quot;heightPixels&quot;: 42, # The height in pixels.
              &quot;widthPixels&quot;: 42, # The width in pixels.
            },
            &quot;mimeType&quot;: &quot;A String&quot;, # MIME type of the image asset.
          },
          &quot;displayUrl&quot;: &quot;A String&quot;, # The webpage address that appears with the ad.
          &quot;finalUrl&quot;: &quot;A String&quot;, # The URL address of the webpage that people reach after they click the ad.
          &quot;trackingUrl&quot;: &quot;A String&quot;, # The URL address loaded in the background for tracking purposes.
          &quot;video&quot;: { # Details of a YouTube video. # The YouTube video of the ad.
            &quot;id&quot;: &quot;A String&quot;, # The YouTube video ID which can be searched on YouTube webpage.
            &quot;unavailableReason&quot;: &quot;A String&quot;, # The reason why the video data is not available.
          },
        },
        &quot;customParameters&quot;: { # The custom parameters to pass custom values to tracking URL template.
          &quot;a_key&quot;: &quot;A String&quot;,
        },
      },
      &quot;mastheadAd&quot;: { # Details for a Masthead Ad. # Details of an [ad served on the YouTube Home feed](//support.google.com/google-ads/answer/9709826).
        &quot;autoplayVideoDuration&quot;: &quot;A String&quot;, # The duration of time the video will autoplay.
        &quot;autoplayVideoStartMillisecond&quot;: &quot;A String&quot;, # The amount of time in milliseconds after which the video will start to play.
        &quot;callToActionButtonLabel&quot;: &quot;A String&quot;, # The text on the call-to-action button.
        &quot;callToActionFinalUrl&quot;: &quot;A String&quot;, # The destination URL for the call-to-action button.
        &quot;callToActionTrackingUrl&quot;: &quot;A String&quot;, # The tracking URL for the call-to-action button.
        &quot;companionYoutubeVideos&quot;: [ # The videos that appear next to the Masthead Ad on desktop. Can be no more than two.
          { # Details of a YouTube video.
            &quot;id&quot;: &quot;A String&quot;, # The YouTube video ID which can be searched on YouTube webpage.
            &quot;unavailableReason&quot;: &quot;A String&quot;, # The reason why the video data is not available.
          },
        ],
        &quot;description&quot;: &quot;A String&quot;, # The description of the ad.
        &quot;headline&quot;: &quot;A String&quot;, # The headline of the ad.
        &quot;showChannelArt&quot;: True or False, # Whether to show a background or banner that appears at the top of a YouTube page.
        &quot;video&quot;: { # Details of a YouTube video. # The YouTube video used by the ad.
          &quot;id&quot;: &quot;A String&quot;, # The YouTube video ID which can be searched on YouTube webpage.
          &quot;unavailableReason&quot;: &quot;A String&quot;, # The reason why the video data is not available.
        },
        &quot;videoAspectRatio&quot;: &quot;A String&quot;, # The aspect ratio of the autoplaying YouTube video on the Masthead.
      },
      &quot;name&quot;: &quot;A String&quot;, # The resource name of the ad.
      &quot;nonSkippableAd&quot;: { # Details for a non-skippable ad. # Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives.
        &quot;commonInStreamAttribute&quot;: { # Common attributes for in-stream, non-skippable and bumper ads. # Common ad attributes.
          &quot;actionButtonLabel&quot;: &quot;A String&quot;, # The text on the call-to-action button.
          &quot;actionHeadline&quot;: &quot;A String&quot;, # The headline of the call-to-action banner.
          &quot;companionBanner&quot;: { # Meta data of an image asset. # The image which shows next to the video ad.
            &quot;fileSize&quot;: &quot;A String&quot;, # File size of the image asset in bytes.
            &quot;fullSize&quot;: { # Dimensions. # Metadata for this image at its original size.
              &quot;heightPixels&quot;: 42, # The height in pixels.
              &quot;widthPixels&quot;: 42, # The width in pixels.
            },
            &quot;mimeType&quot;: &quot;A String&quot;, # MIME type of the image asset.
          },
          &quot;displayUrl&quot;: &quot;A String&quot;, # The webpage address that appears with the ad.
          &quot;finalUrl&quot;: &quot;A String&quot;, # The URL address of the webpage that people reach after they click the ad.
          &quot;trackingUrl&quot;: &quot;A String&quot;, # The URL address loaded in the background for tracking purposes.
          &quot;video&quot;: { # Details of a YouTube video. # The YouTube video of the ad.
            &quot;id&quot;: &quot;A String&quot;, # The YouTube video ID which can be searched on YouTube webpage.
            &quot;unavailableReason&quot;: &quot;A String&quot;, # The reason why the video data is not available.
          },
        },
        &quot;customParameters&quot;: { # The custom parameters to pass custom values to tracking URL template.
          &quot;a_key&quot;: &quot;A String&quot;,
        },
      },
      &quot;videoDiscoverAd&quot;: { # Details for a video discovery ad. # Details of an [ad promoting a video](//support.google.com/displayvideo/answer/6274216) that shows in places of discovery.
        &quot;description1&quot;: &quot;A String&quot;, # First text line for the ad.
        &quot;description2&quot;: &quot;A String&quot;, # Second text line for the ad.
        &quot;headline&quot;: &quot;A String&quot;, # The headline of ad.
        &quot;thumbnail&quot;: &quot;A String&quot;, # Thumbnail image used in the ad.
        &quot;video&quot;: { # Details of a YouTube video. # The YouTube video the ad promotes.
          &quot;id&quot;: &quot;A String&quot;, # The YouTube video ID which can be searched on YouTube webpage.
          &quot;unavailableReason&quot;: &quot;A String&quot;, # The reason why the video data is not available.
        },
      },
      &quot;videoPerformanceAd&quot;: { # Details for a video performance ad. # Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product.
        &quot;actionButtonLabels&quot;: [ # The list of text assets shown on the call-to-action button.
          &quot;A String&quot;,
        ],
        &quot;companionBanners&quot;: [ # The list of companion banners used by this ad.
          { # Meta data of an image asset.
            &quot;fileSize&quot;: &quot;A String&quot;, # File size of the image asset in bytes.
            &quot;fullSize&quot;: { # Dimensions. # Metadata for this image at its original size.
              &quot;heightPixels&quot;: 42, # The height in pixels.
              &quot;widthPixels&quot;: 42, # The width in pixels.
            },
            &quot;mimeType&quot;: &quot;A String&quot;, # MIME type of the image asset.
          },
        ],
        &quot;customParameters&quot;: { # The custom parameters to pass custom values to tracking URL template.
          &quot;a_key&quot;: &quot;A String&quot;,
        },
        &quot;descriptions&quot;: [ # The list of descriptions shown on the call-to-action banner.
          &quot;A String&quot;,
        ],
        &quot;displayUrlBreadcrumb1&quot;: &quot;A String&quot;, # The first piece after the domain in the display URL.
        &quot;displayUrlBreadcrumb2&quot;: &quot;A String&quot;, # The second piece after the domain in the display URL.
        &quot;domain&quot;: &quot;A String&quot;, # The domain of the display URL.
        &quot;finalUrl&quot;: &quot;A String&quot;, # The URL address of the webpage that people reach after they click the ad.
        &quot;headlines&quot;: [ # The list of headlines shown on the call-to-action banner.
          &quot;A String&quot;,
        ],
        &quot;longHeadlines&quot;: [ # The list of lone headlines shown on the call-to-action banner.
          &quot;A String&quot;,
        ],
        &quot;trackingUrl&quot;: &quot;A String&quot;, # The URL address loaded in the background for tracking purposes.
        &quot;videos&quot;: [ # The list of YouTube video assets used by this ad.
          { # Details of a YouTube video.
            &quot;id&quot;: &quot;A String&quot;, # The YouTube video ID which can be searched on YouTube webpage.
            &quot;unavailableReason&quot;: &quot;A String&quot;, # The reason why the video data is not available.
          },
        ],
      },
    },
  ],
  &quot;nextPageToken&quot;: &quot;A String&quot;, # A token to retrieve the next page of results. Pass this value in the page_token field in the subsequent call to `ListAdGroupAds` method to retrieve the next page of results.
}</pre>
</div>

<div class="method">
    <code class="details" id="list_next">list_next()</code>
  <pre>Retrieves the next page of results.

        Args:
          previous_request: The request for the previous page. (required)
          previous_response: The response from the request for the previous page. (required)

        Returns:
          A request object that you can call &#x27;execute()&#x27; on to request the next
          page. Returns None if there are no more items in the collection.
        </pre>
</div>

</body></html>